CONTENTS | INDEX | PREV | NEXT
CreateGlobalDiceRexxPort
FUNCTION
Create a global ARexx port (DICE)
SYNTAX
#include <lib/rexx.h>
rc = CreateGlobalDiceRexxPort(port, name)
int rc;
struct MsgPort *port;
char *name;
DESCRIPTION
CreateGlobalDiceRexxPort integrates any number of ARexx ports beyond
the master port into DICE's ARexx system. This call may be made from
any point in your program. After this call returns the message port
will accept incomming ARexx messages.
|| NOTE: For simple programs you can simply use the master port
|| (RexxPort) that DICE sets up for you automatically and need not
|| bother with creating additional ports. This call is more of use
|| in more complex programs which handle multiple projects
|| simultaniously.
If you had declared RexxHostName as NULL causing DICE to not
initialize an internal default RexxPort, you can pass NULL for
msgPort to initialize DICE's internal default RexxPort, thereby
allowing PlaceRexxCommand calls that specify a NULL port (i.e. to use
DICE's internal default RexxPort). You are not required to use
DICE's internal message port, it is simply convenient.
INPUTS
struct MsgPort *port;
A blank msgPort structure (that is, totally
zero'd out). DICE will fill the structure with
appropriate values. DICE uses the same signal bit
as it allocated for the master port (RexxPort).
DICE will make this message port public through
the AddPort() call.
char *name; A pointer to the name of the message port. DICE
uses this name verbatim. An error (-1) is
returned if the port already exists. If you had
passed NULL for the MsgPort structure DICE will
initialize RexxHostName to name.
RESULTS
int r; 0 for success, -1 for error